home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Meeting Pearls 4
/
Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso
/
Pearls
/
libs
/
Identify
/
Identify.doc
< prev
next >
Wrap
Text File
|
1996-09-14
|
9KB
|
262 lines
TABLE OF CONTENTS
identify.library/IdAlert
identify.library/IdExpansion
identify.library/IdFunction
identify.library/IdHardware
identify.library/IdAlert identify.library/IdAlert
NAME
IdAlert - get description of an alert (V3)
SYNOPSIS
Error = IdAlert(Code,TagList)
D0.l D0.l A0.l
LONG IdAlert(ULONG, struct TagItem *);
Error = IdAlertTags(Code,Tag1,...)
LONG IdAlertTags(ULONG, ULONG,...);
FUNCTION
Get a human readable description of the alert ('Guru') code.
INPUTS
Code -- (ULONG) alert code, as defined in exec/alerts.h
TagList -- (struct TagItem *) tags that describe further
options:
IDTAG_DeadStr -- (STRPTR) Alert type string (deadend
or recoverable). You may skip this tag if you
do not want to get the string.
IDTAG_SubsysStr -- (STRPTR) String of the subsystem
that caused the alert (CPU, exec.library, ...).
You may skip this tag if you do not want to
get the string.
IDTAG_GeneralStr -- (STRPTR) General alert cause. You
may skip this tag if you do not want to get
the string.
IDTAG_SpecStr -- (STRPTR) Specified alert cause. You
may skip this tag if you do not want to get
the string.
IDTAG_StrLength -- (UWORD) Maximum length of the
string buffer, including termination. Defaults
to 50.
RESULT
Error -- (LONG) error code, or 0 if everything went fine.
NOTE
This call is guaranteed to preserve all registers except D0.
BUGS
SEE ALSO
identify.library/IdExpansion identify.library/IdExpansion
NAME
IdExpansion - get name of expansion board (V3)
SYNOPSIS
Error = IdExpansion(TagList)
D0.l A0.l
LONG IdExpansion(struct TagItem *);
Error = IdExpansionTags(Tag1,...)
LONG IdExpansionTags(ULONG,...);
FUNCTION
Gets the name and class of the expansion and it's manufacturer.
INPUTS
TagList -- (struct TagItem *) tags that describe further
options:
IDTAG_ConfigDev -- (struct ConfigDev *) ConfigDev
structure containing all information. You
should use this tag if ever possible, since
there are more possibilities to recognize and
distinguish between a board.
IDTAG_ManufID -- (UWORD) Manufacturer ID if ConfigDev
is not provided. You also have to provide
IDTAG_ProdID!
IDTAG_ProdID -- (UBYTE) Product ID if ConfigDev
is not provided. You also have to provide
IDTAG_ManufID!
IDTAG_ManufStr -- (STRPTR) Pointer to a buffer space
for the manufacturer name. You may skip this
tag if you do not want to get this string.
IDTAG_ProdStr -- (STRPTR) Pointer to a buffer space
for the product name. You may skip this tag if
you do not want to get this string.
IDTAG_ClassStr -- (STRPTR) Pointer to a buffer space
for the product class. You may skip this tag if
you do not want to get this string.
IDTAG_StrLength -- (UWORD) Buffer length, including
termination. Defaults to 50.
RESULT
Error -- (LONG) error code, or 0 if everything went fine.
NOTE
If the manufacturer or the product is not known, the string will be
filled with its number.
This call is guaranteed to preserve all registers except D0.
BUGS
There are by far not all existing boards implemented. Please send
the manufacturer id and name and the products id, name and class
of all unknown boards to me. My E-Mail: "rkoerber@tfh.dssd.sub.org".
SEE ALSO
identify.library/IdFunction identify.library/IdFunction
NAME
IdFunction - identify function name by offset (V4)
SYNOPSIS
Error = IdFunction(LibName,Offset,TagList)
D0.l A0.l D0.l A1.l
LONG IdFunction(STRPTR, LONG, struct TagItem *);
Error = IdFunctionTags(LibName,Offset,Tag1,...)
LONG IdFunctionTags(STRPTR, LONG, ULONG,...);
FUNCTION
Decodes the offset of the provided library name into function name.
This function requires the .fd files in a drawer with 'FD:' assigned
to it. All files must have the standard file name format, e.g.
'exec_lib.fd'.
The appropriate .fd file will be scanned. The result will be
cached until the identify.library is removed from system.
INPUTS
LibName -- (STRPTR) name of the function's library, device
or resource. All letters behind the point (and
the point itself) are optional. The name is
case sensitive.
Examples: 'exec.library', 'dos', 'cia.resource'.
Offset -- (LONG) offset of the function. It must be a
multiple of 6. You do not need to provide the
minus sign.
Examples: -456, 60
TagList -- (struct TagItem *) tags that describe further
options:
IDTAG_FuncNameStr -- (STRPTR) Buffer where the function
name will be copied into.
IDTAG_StrLength -- (UWORD) Maximum length of the
string buffer, including termination. Defaults
to 50.
RESULT
Error -- (LONG) error code, or 0 if everything went fine.
NOTE
This call is guaranteed to preserve all registers except D0.
BUGS
Every line in the .fd file must have a maximum of 98 characters.
Otherwise the internal offset table may be corrupted (but the
system won't crash). Anyhow, this should be no problem.
SEE ALSO
identify.library/IdHardware identify.library/IdHardware
NAME
IdHardware - get information about the system (V3)
SYNOPSIS
String = IdHardware(Type,TagList)
D0.l D0.l A0.l
STRPTR IdHardware(ULONG, struct TagItem *);
String = IdHardwareTags(Type,Tag1,...)
STRPTR IdHardwareTags(ULONG, ULONG,...);
FUNCTION
Gets information about the current system environment. This function
is fully DraCo compatible!
INPUTS
Type -- (ULONG) Information type. These types are known:
IDHW_SYSTEM -- What system is used?
(e. g. "Amiga 4000")
IDHW_CPU -- What kind of CPU is available?
(e. g. "68060")
IDHW_FPU -- What kind of FPU is available?
(e. g. "68060")
IDHW_MMU -- What kind of MMU is available?
(e. g. "68060")
IDHW_OSVER -- What OS version is used?
(e.g. "V39.106")
IDHW_EXECVER -- What exec version is used?
(e.g. "V39.47")
IDHW_WBVER -- What WorkBench version is used?
(e.g. "V39.29")
IDHW_ROMSIZE -- Size of AmigaOS ROM
(e.g. "512KB")
IDHW_CHIPSET -- What Chipset is available?
(e.g. "AGA")
IDHW_GFXSYS -- What Graphic Board System is used?
(e.g. "CyberGraphX")
IDHW_CHIPRAM -- Size of complete Chip RAM
(e.g. "2MB")
IDHW_FASTRAM -- Size of complete Fast RAM
(e.g. "12MB")
IDHW_RAM -- Size of complete System RAM
(e.g. "14MB")
IDHW_SETPATCHVER -- [V4] Version of current SetPatch
(e.g. "V40.14")
TagList -- (struct TagItem *) tags that describe further
options. Currently, there are none. You may
provide NULL.
RESULT
String -- (STRPTR) String containing the desired
information, or NULL if not available. Note that
all strings are READ ONLY!
NOTE
This call is guaranteed to preserve all registers except D0.
BUGS
SEE ALSO